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INTRODUCTION 

This Installation Guide describes the procedure for 
generating a configuration of Turbo-Plus in a system which 
includes 16-bit boards. 

For information on the 8-bit installation, refer to the 8- 
bit Installation Guide to Turbo-Plus . For information on using 
the package refer to the User' s Guide to Turbo-Plus . That 
document includes an overview of the package, and instructions on 
using each command. 

Turbo-Plus Is designed with the ability to be patched to run 
on systems with different search drives. Since it needs to know 
what drive this is, it is set up as a patchable parameter. Thus, 
most of Turbo-Plus's modules are distributed as relocatable ( .0) 
files, so that parameters may be 'plugged in' in the installation 
procedure using the TurboDOS symbolic patch facility described in 
the Configuration Guide to TurboDOS . 

Section 2 of this guide briefly describes all of the modules 
sent as part of the 16-bit Turbo-Plus package, and explains where 
on the system they should be placed. 



Section 3 describes the installation procedure for 
generating a customized version of Turbo-Plus excluding the 
background batch processor, which involves some extra steps. 

Section 4 describes the installation procedure for the 16- 
o > t, background batch processor. 
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Qvervi ew 

Turbo-Plus makes extensive use of the TurboDOS User Defined 
Function (TurboDOS call 0x29) and follows the USESUP calling 
protocol, outlined in your TurboDOS 1.41 update notes, and in 
Appendix G of the 8-bit installation manual. Therefore. if you 
wish to add your own functions with this call, it is imperative 
that you also follow the USESUP protocol, which has been adopted 
by Software 2000 as the standard TurboDOS method. 



Serialization 



Each copy of Turbo-Plus is serialized to be run only 



TlflflU /♦!! 1 O T» 



T« nhftHrtS 






rt T» O T» Q + i -n a 



Swot etm 






:e 



nlol 



on a 



coincides with that of the operating system on which it is to be 
run. None of the modules in Turbo-Plus will run on any system 
with a serial number different that its own. 
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Turbo-Plus 16-bit Installation 

Check List 

THIS CHECKLIST IS FOB PUBE 16 BIT INSTALLATIONS ONLY 



[ ] 1. Bead the Turbo-Plus 16-bit Installation Guide. 

[ ] 2. Bun INSTALL, OMB. 

This program will prompt you for your TurboDOS version, 
your system boot drive, and your system search drive. 
It will then create the proper .PAB files for your 
configuration and proceed to GEN the Turbo-Plus 
modules. When GEN is complete, it will copy all of the 
appropriate files to their correct destinations on your 
system. 

f a 3. Bun BBIN3TAL.CMD ! OPTIONAL! 

If you desire to use the Background Batch commands, it 
will be necessary to run this installation program. 
BBINSTAL will ask the same questions as above and in 
addition will require a particular user area 
designation where it can reside when idle and maintain 
it's files. 



[ 3 4. 
[ ] 5. 

[ 3 6. 



COPY all help ( .HLP) files from Distribution Disk(s) 
to user of your search drive. 

COPY TPLUSS.O, TPLUSM.O, C0N96TP.0, CONBB.O, TWXTV.O 
and TWXNUL.O to the area of your disk where you 
generate your TurboDOS systems. 



GEN 



all Slaves - Be sure that each OSSLAVEx.GEN 



includes C0N96TP.0 (replacing your existing C0N96.0), 
TPLUSS.O and TWXTV.O (or TWXNUL.O), as well as 
USBSUP.O, NETSVC.O and NETFWD.O (all supplied by 
Software 2000, Inc., but not generally included in 
slave general '02i) . 

[ ] 7. GEN Background Batch slave, i OPTIONAL! 

[ ] a. In order to allow the BATCH PBOCESSING slave to recover 
from console input conditions (illegal in BB), 
substitute CONBB.O for C0N96TP.0 on the OSSLAVEx.GEN 
designated in the BBINSTAL session. 

[ ] b. Include LOGUSB = NN (where NN = user area specified in 
BBINSTAL - i.e. LOGUSB = OxlE for area 30) in this 
OSSLAVEx.PAB file. 

(Cont'd) 
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[ ] 8. If you are running a 16-bit master, GEN the master 
(OSMASTEB.SYS) . 

Be sure to include TPLUSM.O as well as USRSUP.O, 
NETFWD.O, NETREQ.O and MSGFMT.O (supplied by Software 
2000, Inc.) in the OSMASTER.GEN file. 

[ ] 9. Beset and test your system. You should first notice 
the new Turbo-Plus LOGON program if everything is 
properly installed. 
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Turbo-Plus Modules 

16 bit Turbo-Plus will arrive on two sides of one CP/M 
format single-sided single-density diskette. Side one contains 
all of the relocatable modules; side two contains .DO, .GEN, and 
.PAR files used to generate your Turbo-Plus installation. 

Program Modules 

Side one contains three types of files: 

1) Beloeatable program files: 

Those files which constitute the main bodies of the 
Turbo-Plus utility programs. 

2) Relocatable subroutine files: 

Those files which contain subroutines called by the 
programs above. 

3) System function files: 

Files containing extensions to the normal set of 
TurboDOS operating system calls which must be genned 
into the operating system. 



Side two contains all of the supporting files used for 
generating your installed version of Turbo-Plus. This includes 
.GEN and . PAE files for your programs, auxiliary data files, two 
installation ,CMD files, and .DO files referenced by the install 
programs. 
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Relocatable and executable program files 

These ape all of the files containing the assembled source 
code for the Turbo-Plus utilities. They are distributed in 
relocatable form, to allow the patching of parameters. 



DIRDUMP.O 
GO.O 

GONAME . 
HELP . 

LOCATE. 
LOG . 
LOGOFF . 
LOGON. 

MAIL.O 

MASTTMJ n 

PROFILE. 
RESET . 
STATUS . 

TWX.O 

USER . 

WHO.O 



Program which gives a master directory of any disk, 
sorted by user area. 

Program which moves users to a user area specified 
by a user-defined name. 

Utility which allows users to define names for user 
areas on the system. 



1 n /\n 

x y vu 



TurbouOS on-line help facility providing 

all TurboDOS and Turbo-Plus commands. Users may 

add their own help files. 

Utility to search certain or all system drives for 
given file or template. 

Utility to make entries in a date and time stamped 
log file. 

Enhanced version of system logoff, notifying users 
of pending mail, and displaying system bulletins. 

Enhanced version of system logon, notifying users 
of pending mail, displaying system bulletins, and 
providing additional levels of security. 

TurboDOS mail facility to allow electronic mail to 
be sent among users on the system. 

Enhanced version of the TurboDOS 'MASTER' command, 
providing better control of access to the master. 

Program to maintain USERID.SYS file. 

Program to reset a slave from another slave. 

Facility to continuously monitor activity of system 
users, printers, and buffers. 

TWX facility to allow users to send immediate 
messages to other consoles on the system. 

Allows user to change user areas. Performs the 
same function as the TurboDOS USER command of 
versions 1.3 and earlier. 

System status facility to display all current users 
on the system, processes they are running and other 
current system characteristics. 
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Relocatable subroutine files 

A number of routines are shared by various program modules 
include the following files: 



They 



DBUPF . 
LOGDAT . 
PTABLB.O 
TPDATE.O 



GBUFF . 
MBUFF.O 
TABLES . 
TPSCAN.O 



LOGCHK.O 
MROUTE . 
TPMOD.O 



System function files 

These files must be moved to the user area on the system where 
your system's .GEN and .PAR files reside, and where your system 
generation takes place. Some of them must be genned into your 
system in order for Turbo-Plus to work. There are six such 
files, all on side 1: 



TPLUSS.O 
TWXNUL.Q 
C0N96TP , 



TPLUSM.O 
TWXTV.O 
CONBB . 



-iH!N and .PAR files 

The^e files are necessary to patch the modules to work under your 
system configuration. 

All of the following programs have .GEN files, some of which are 
accompanied by .PAR files: 



DIRDUMP 
LOCATE 
MAIL 
STATUS 



GO 
LOG 

MASTER 
TWX 



GONAME 
LOGOFF 
PROFILE 
USER 



HELP 
LOGON 
RESET 
WHO 



The following files are n^cassary for the installation procedure 

TPLUS6 , DO INSTALL . CMD 
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Installing Turbo-Plus 

Generating executable programs 

Before you begin your Turbo-Plus installation, make a backup 
of the distribution diskette(s). If you received Turbo-Plus on a 
single TurboDOS format disk, you may run the install procedure 
directly from that disk. If not, you must copy the first two 
disks onto any user area on the system other than user zero of 
the search drive. 

To customize Turbo-Plus to your system configuration, 
execute the INSTALL command. This program will prompt you for 
your TurboDOS version number, system search drive and the drive 
which currently contains your system boot disk (do not include 
the colon after the drive letters); all of the necessary .CMD 
files will be generated and moved down to the search drive. 
Then, all of the ,HLP files should be moved from the distribution 
disk to user zero of the search drive. During execution of the 
INSTALL process, it is very possible that certain stages will 
return with system error messages such as 'File not found'. This 
is due to the fact that the procedure must make sure that if any 
of these programs were already present, in an older version, they 
are deleted. Thus, if the programs were not there, trying to 
delete them will yield error messages. 

Note : If you do not have a system search drive, you must 
still give some drive parameter to be used by Turbo-Plus as the 
dri^s on which to maintain all of its files. 
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System Generation 

Before Turbo— Plus may be brought up, it is necessary to 
generate a new operating system. You should start with the .GEN 
and . PAE files which you are currently using for both your 
slave(s) and your master, but some additions will be necessary. 

Generating a new system master 

The following changes must be made to the .GEN file for your 
system master (usually STDMASTE.GEN or OSMASTER.GEN) . Using your 
system editor, insert the following lines. 

NETREQ 
MSGFMT 

USRSTJP 
TPLUSM 

If you have the ability to use the TWX and RESET commands, 
it is recommended that you use modified circuit drivers. Many 
existing circuit drivers have already been modified 
appropriately; if your dealer says that yours has not been, a 
revision will be necessary. There should be no change made to 
the master circuit driver, and the source for your slave circuit 
driver should be changed, following the instructions in Appendix 
A. 

If you are running a multi-circuit system, one patch line 
will be required in your master .PAR file. For a full 
explanation of this patch point, refer to Appendix B in the 8-bit 
installation manual. 

Figure 3.1 shows a sample OSMASTER.GEN file prepared for 
Turbo-Plus . 
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STDMASTE 

NETFWD 

NETBEQ 

MSGFMT 

HDWNIT 

USRSUP 

TPLUSM 

CONREM 

LSTPAH 

LSTETX 

LSTTAB 

SPDXXX 

BRTXXX 

RTCXXX 

DSKXXX 

DST58P 

DSKHHH 

MCDXXX 



Figure 3.1 
Sample OSMASTER.GEN file 

STANDARD NETWORK MASTER CONFIGURATION 

NETWORK MESSAGE FORWARDING 

NETWORK REQUEST PROCESSOR 

NETWORK MESSAGE FORMAT TABLE 

HARDWARE INITIALIZATION 

USER FUNCTION MAIN CALLING MODULE 

TURBO-PLUS FUNCTION EXTENSIONS 

REMOTE MASTER CONSOLE 

DRIVER FOR HIGH SPEED PRINTER 

DRIVER FOR LETTER QUALITY PRINTER 

DRIVER FOR HIGH SPEED PRINTER EXPANDING TABS 

SERIAL & PARALLEL DRIVERS 

BAUD-RATE TABLES 

REAL-TIME CLOCK DRIVER 

FLOPPY DISK DRIVER 

FLOPPY DISK SPECIFICATION TABLES 

HARD DISK DRIVER 

MASTER CIRCUIT DRIVER 



Figure 3.2 
Sample OSMASTER.PAR file 



COMPAT 


s 


OxFO 


NMBSVC 


= 


9 


NMBXXX 


= 


9 


NMBMBS 


= 


OxlB 


NMBUFS 


= 


OxlO 


NMBRPS 


= 


OxlB 


> 
PATXXX 


= 


0x60 


DSKAST 


= 


00, D 



Compatibility flags 

Number of slaves 

Number of slaves (9) 

Number of message buffers (27) 

16 I/O buffers 

Number of network reply packets 



(27) 



0x60 , 0x62 , 0x64 , 0x66 , 0x68 , 0x6A , 0x6C , 0x6E , 0x70 

Slave Port assignment table 
00 , DSKDRA ,01, DSKDRA , 00 , DSKDRB , 01 , DSKDRB , 02 , DSKDRB , 03 , DSKDRB , 
04 , DSKDRB , 05 , DSKDRB , 06 , DSKDRB , 07 , DSKDRB , 08 , DSKDRB , 09 , DSKDRB , 
OxOA , DSKDRB , OxOB , DSKDRB 

Disk assignment table: 
A,B = floppy drives 
C-N = Winchester disk 
PTRAST = 00,LSTDRA,01,LSTDRB,00,LSTDRC 

Printer assignment table: 

A - High speed with raw output 
B = Letter quality with raw output 
C = High speed w/ formatted output 
Reserved memory above TPA 



MEMRES 
DSPPAT 



AUTUSR 
QUEAST 

SRHDRV 
ETXBR = 



(0x1000) 
1,2,0,0,0,0,0,0,0,0,0 

De-Spool 



= 0x80 

= 00, (0) ,00, (0), 00 

= 8 
OxOE 



t ab 1 e : 
Printer A — > 
Printer B — > 
Log master on to 
(0), 00,(0), 00,(0) 
Define eight valid queues 
System search drive = H 
Baud rate on Printer B = 9600 



Queue A 
Queue B 

user 0, privileged 
00,(0), 00,(0), 00,(0) 
(A-H) 
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Generating new slaves 

Next, in your slave .GEN files, add lines containing XJSHSUP 
and TPLTJSS following the hardware initialization module. You 
should also include NETFWD and msTSVG immediately after the line 
for STDSLAVE. Also, to optimize the performance of the TWX 
command, you need a special console driver, modified circuit 
drivers, and a separate module to handle the shift— in shift— out 
produced by TWX. 

If your standard console driver is C0N96, you may use the 
C0N96TP driver provided with Turbo-Plus. (To do so, simply 
replace the C0N96 line in your .GEN file with C0N96TP) . If not, 
you should modify your driver such that before every console 
output, it performs a WAIT operation on the global semaphore: 

TUT nnXT a *\A a * + o t» ao /»Vi nnnenl a #-iii ♦ -mi +_ i ♦. «ar»f ft T»m o a iQ TfTKIAT. 

operation on the same semaphore. It should also allow for a 
character to remove the TWX message from the 25th line of the 
screen, by calling the external routine TWXRST when this 
character is received. C0N96TP uses the ESC character by 
default, and if there is no message on the status line, it allows 
the escape to passed through normally. Figure 3.5 shows the 
C0N96TP driver, which may be used as a guideline. 

Furthermore, for those of you using TWX and RESET, your 
circuit driver may require modification. Consult appendix A for 
the necessary changes. 

The second module necessary for TWX handles the placing of 
TWX messages on the screen without interrupting normal console 
input/output. If you are using a Televideo terminal, you may use 
the TWXTV module, which places all received TWX messages on the 
terminal status line. For any other terminal you may use the 
TWXNUL module, which simply prints each line at the current 
cursor position, followed by a carriage return-line feed 
sequence. A source listing of this module is provided and 
explained in Figure 3.6, in case you wish to modify it for your 
specific terminal. Modification may be done either by writing 
your own driver, our patching TWXNUL in the slave .PAR file. 

Figure 3.4 shows a sample slave .GEN file and figure 3.3 
shows the corresponding .PAR file. 



Once all of these changes are complete, you are ready to 
generate the new master and slaves using the GEN command in the 
usual way. (Refer to the TurboDOS configuration Guide.) Once all 
of these steps are done, copy the newly created .SYS files down 
to user zero of your boot disk, and Turbo-Plus will be ready to 
come up. 
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Figure 3.3 
Sample STDSLAVE.PAR file 



COMPAT = 


OxPO 


SEHDRV = 


8 


PRTMOD = 


01 


QUEPTR = 


1 


SPLDRV = 


8 



File Compatibility flags 
System search drive = H 
Print mode = Spooled 
Default Queue = A 
Spool Drive ■ I 



STDSLAVE 

NETFWD 

NET SVC 

NITXXX 

USRSUP 

TPLUS3 

CON96TP 

TWXTV 

8LVRES 
SGDXXX 



Figure 3.4 
Sample STDSLAVE. GEN file 

STANDARD NETWORK SLAVE CONFIGURATION 

NETWORK MESSAGE FORWARDING 

NETWORK SERVICE PROCESS 

HARDWARE INITIALIZATION 

USER FUNCTION INTERFACE 

TURBO-PLUS FUNCTION EXTENSIONS 

TURBO-PLUS ASCII CONSOLE AT 9600 BAUD 

TWX CONSOLE MANAGER FOR TELEVIDEO 950/925/800 

SERIAL & PARALLEL DRIVERS 

SUBROUTINE FOR KEYBOARD RESET OF SLAVE 

SLAVE CIRCUIT DRIVER 



Special hardware-dependent modules, described in the paragraphs 
above, are in boldface. 
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Figure 3.5 
Sample Turbo-Plus Console Driver 
C0N96TP: TUBBODOS OPERATING SYSTEM NULL CONSOLE DRIVES 
COPYRIGHT 1984, SOFTWARE 2000, INC. 
Page 1 



COPYRIGHT 1984, SOFTWARE 2000, INC 
VERSION: 01/03/84 



Edit History: JBG 
JBG 
JBG 



24-Aug-83 : Revised for TurboDOS VI. 30 
12-Mar-84 : 16 bit conversion completed 
3-Dec-84 : Clear status line logic added 



# INCLUDE 



MuDULE Js uuwyt5T±'" ;nuDUiiia jnahej 

DREQUATE" ; DRIVER SYMBOLIC EQUIVALENCES 
LOC Data# ; LOCATE IN DATA SEGMENT 

; CONSOLE BAUD RATE CODE (9600 BAUD) 



RESTORE 25TH LINE CHARACTER 
FORM FEED CHARACTER 
INITIALIZATION COMPLETE FLAG 



CONBR: : 


BYTE 


0x8E 


R25CHR: 


: 






BYTE 


OxlB 


FFCHR: : 


BYTE 


AFF 


INITC: 


BYTE 





EFLAG: 


BYTE 





BCOUNT : 


BYTE 





SCOUNT : 


WORD 






LOC 



Code# 



LOCATE IN CODE SEGMENT 



CONDR_: 


:MOV 


AL, INITC 




TEST 


AL.AL 




JNZ 


CDRV 




GALL 


INIT 


CDRV: 


MOV 


AL.DL 




SUB 


AL,=8 




JNZ 


NSO 




JMP 


CONSO 


NSO: 








DEC 


AL 




JNZ 


NSI 




JMP 


CONS I 


NSI: 








DEC 


AL 




JNZ 


NOPT 




JMP 


OPT 


NOPT : 








MOV 


AL.DL 




OR 


AL.AL 




JZ 


CONST 




DEC 


AL 




JZ 


CONIN 




DEC 


AL 



GET INIT COMPLETE FLAG 

INITIALIZATION COMPLETE FLAG SET? 

IF SO, CONTINUE 

ELSE, INITIALIZE CONSOLE CHANNEL 

GET FUNCTION NUMBER 

FUNCTION NUMBER=8? 

IF SO, ERROR SHIFT OUT 

FUNCTION NUMBERS? 

IF SO, ERROR SHIFT IN 

FUNCTION NUMBER = 10? 

IF SO, JUMP TO OPTIMIZED OUTPUT ROUTINE 

GET BACK IN A 

IF 0, GO TO CONSTAT 

IF 1, CONIN 

IF 2, CONOUT 
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C0N96TP: TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
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Page 2 



INIT: 



NITX 



^ONXN' 



SER: 



RET: 



JNZ 

JMP 


S 
CONOUT 


JMP 


SERIAL# 


MOV 


INITC 5 ^GxFF 


PUSH 


DX 


PUSH 


GX 


MOV 


CL.CONBB 


MOV 


DL,=S 


CALL 


SERIAL# 


MOV 


AL.FFCHR 


TEST 


AXj , AL 


JZ 


NITX 


POP 


CX 


PUSH 


CX 


MOV 


CL.AL 


MOV 


DL,=2 


CALL 


SERIAL# 


POP 


CX 


POP 


DX 


RET 




MOV 


AL.EFLAG 


OR 


AL.AL 


JZ 


SER 


XOR 


AL,AL 


CALL 


RELEAS 


PUSH 


CX 


PUSH 


DX 


CALL 


SERIAL# 


PUSH 


AX 


AND 


AL,=0x7F 


MOV 


CH.AL 


MOV 


AL.R25CHR 


CMP 


AL.CH 


JNZ 


RET 


MOV 


AL,LINE25# 


OR 


AL,AL 


JZ 


RET 


CALL 


TWXRST# 


POP 


AX 


POP 


DX 


POP 


CX 


JMP 


SERIAL# 


POP 


AX 


POP 


DX 


POP 


CX 



SET INIT COMPLETE FLAG 

SAVE FUNCTION NUMBER 

SAVE CHANNEL NUMBER/ CHARACTER 

GET CONSOLE BAUD RATE CODE 

SET FUNCTION NUMBER=3 

SET CHANNEL BUAD RATE 

GET FORM FEED CHARACTER 

FORM FEED CHARACTERS? 

IF SO, CONTINUE 

ELSE, RESTORE CHANNEL NUMBER 

SAVE CHANNEL NUMBER 

FORM FEED CHARACTER TO C-REG 

SET FUNCTION NUMBER=2 

OUTPUT FORM FEED 

RESTORE CHANNEL NUMBER/ CHARACTER 

RESTORE FUNCTION NUMBER 

DONE 



IF ESCAPE FLAG IS SET 



RESET FLAGS AND SEMAPHORE 

ENDIF 

SAVE CHANNEL NUMBER 

AND FUNCTION NUMBER 

GET THE CHARACTER 

SAVE IT 

STRIP PARITY 

SAVE IT 

COMPARE TO 25TH LINE RESTORE 

IF SO 

CHECK FOR PRESENCE OF MESSAGE 

IF NONE, SKIP THIS 

RESTORE THE LINE 

GET REGISTERS OF THE STACK 

. BECAUSE WE NEED THE FUNCTION IN E 

. AND THE CHANNEL IN B 

GO AHEAD TO SERIAL# 
ELSE 

GET CHAR BACK IN A 

RESTORE THE STACK 
ENDIF 
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RET 



; RETURN 



CONST 



MOV 


AL.EFLAG 


OR 


AL,AL 


JZ 


SER 


PUSH 


BX 


MOV 


BX.SCOUNT 


INC 


BX 


MOV 


SCOUNT.BX 


MOV 


AL,BH 


OR 


AL,BL 


JNZ 


NR 


CALL 


RELEAS 


NR: 




POP 


BX 


SER: 




PUSH 


CX 


CALL 


SERIAL# 


POP 


DX 


OR 


AL , AL 


JNZ 


C 


RET 




C: 




PUSH 


AX 


PUSH 


CX 


AND 


CL,=0x7F 


MOV 


CH.CL 


MOV 


AL.R25CHR 


CMP 


AL,CH 


JNZ 


RST 


MOV 


AL,LINE25# 


OR 


AL,AL 


JZ 


RST 


"CALL 


TWXRST# 


MOV 


CH.DH 


MOV 


DL,=1 


CALL 


SERIAL# 


POP 


CX 


POP 


AX 


XOR 


AL.AL 


JMP 


RET 


RST: 




POP 


CX 


POP 


AX 



RET 



RET 



IF ESCAPE FLAG IS SET 



SAVE HL 

CHECK CON STAT COUNT 

BUMP IT 

SAVE NEW STAT COUNT 



RELEASE ESCAPE FLAG 

ENDIF 

RESTORE HL 
ENDIF 

SAVE CHANNEL NUMBER 
AND GO TO SERIAL 
GET CHANNEL NUMBER BACK IN D 
IF NOTHING AVAILABLE, JUST RETURN 



SAVE REGISTERS FOR RETURN 

STRIP PARITY 

SAVE IT 

COMPARE TO 25TH LINE RESTORE 

IF SO 

CHECK FOR PRESENCE OF MESSAGE 

IF NONE, SKIP THIS 

RESTORE THE LINE 

GET CHANNEL NUMBER BACK IN B 

CALL CONIN TO FLUSH THE BYTE 

GET REGISTERS OFF STACK 

FLAG NO CHARACTER AVAILABLE 
ELSE 

RESTORE REGISTERS NORMALLY 

ENDIF 
RETURN 



RELEAS: 



MOV 
MOV 



EFLAG.AL 
BCOUNT , AL 
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C0N96TP: TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 
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PUSH 


CX 


SAVE REGISTERS 


PUSH 


DX 




PUSH 


RX 


m 


MOV 


BX,&TWLOCK# 


RELEASE CONSOLE 


CALL 


SIGNAL# 


# 


POP 


BX 


RESTORE REGISTERS 


POP 


DX 


i 


POP 


CX 


, ENDIF 


RET 

» 




RETURN 


CONOUT : 

MOV 


AL, EFLAG 


IF WE ARE IN THE MIDDLE OF AN ESC- 


OR 


AL.AL 


T 


JZ 


NSEQ 


, 


MOV 


AL, BCOUNT 


GET BYTE COUNTER 


DEC 


AL 


DECREMENT IT 


MOV 


BCOUNT , AL 


STORE IT 


JNZ 


CONT 


IF IT'S ZERO 


MOV 


EFLAG , AL 


TURN OFF ESCAPE FLAG 


JM? 


CONT 


ENDIF 


NSEQ : 




ELSE 


MOV 


AL.CL 


GET BYTE IN A 


AND 


AL,=Ox?F 


STRIP PARITY 


CMP 


AL,=OxlB 


CHECK FOR ESCAPE 


JNZ 


NESC 


IF ESCAPE 


OR 


AL , =OxFF 


SET FLAG 


MOV 


EFLAG, AL 


i 


INC 


AL 


# 


MOV 


WORD SCQUNT,=OxOC 


) ; AND INITIALIZE STAT COUNTER 


NESC: 




ENDIF 


PUSH 


CX 


SAVE REGISTERS 


PUSH 


DX 


# 


PUSH 


BX 


. 


MOV 


BX,&TWLOCK# 


WAIT FOR CONSOLE FREE 


CALL 


WAIT# 


, 


POP 


BX 


RESTORE REGISTERS 


POP 


DX 


* 


POP 


CX 


# 


CONT: 




; END IF 


MOV 


AL,CL 


; GET BYTE IN A 


AND 


AL,=0x7F 


; STRIP PARITY 


CMP 


AL,=OxlB 


; IF IT'S AN ESCAPE 


JNZ 


NE2 


i , 


MOV 


AL,=6 


; INITIALIZE BYTE COUNTER 


MOV 


BCOUNT , AL 


| # 


OR 


AL,=OxFF 


; SET FLAG 


MOV 


EFLAG, AL 


\ . 


INC 


AL 


; AND INITIALIZE STAT COUNT 


MOV 


BYTE SCOUNT.AL 


' # 


MOV 


SCOUNT+l.AL 


; 



NE2: 



ENDIF 
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C0N96TP: TURBODOS OPERATING SYSTEM NULL CONSOLE DKIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 
Page 5 



PRINT THE BYTE 
CHECK ESCAPE FLAG 
IF IT WAS NOT SET 



NR: 



OPT 



NR: 



NSEQ: 



CALL 


SERIAL# 


MOV 


AL , EFLAG 


OR 


al'al 


JZ 
RET 


NR 


PUSH 


CX 


PUSH 


DX 


PUSH 


BX 


MOV 


BX,&TWLOCK# 


n AT T 
l/AJLIXJ 


O T rfTKT A T U. 

a x vxiai Axitr 


POP 


BX 


POP 


DX 


POP 


CX 


RET 




JMP 


SERIAL# 


MOV 


AL,TWL0CK# 


OR 


AL,AL 


JNZ 


NR 


RET 




MOV 


AL, EFLAG 


OR 


AL,AL 


JZ 


NSEQ 


XOR 


AL,AL 


RET 




MOV 


AL.CL 


AND 


AL,=0x7F 


SUB 


AL,=AESC 


JNZ 


NR1 


RET 





NR1: 



JMP 



CONSO: 

CONS I: CALL 
BYTE 
RET 

END 



SERIAL# 



SAVE REGISTERS 

RELEASE CONSOLE 

RESTORE REGISTERS 

ENDIF 
RETURN 



LOOK AT TWX LOCK 

IF IN USE, RETURN UNSUCCESSFUL 



ELSE, IF IN MIDDLE OF ESCAPE SEQUENCE 

RETURN UNSUCCESSFUL 
ELSE IF THE CHARACTER IS AN ESCAPE 

RETURN UNSUCCESSFUL 
ELSE, JUST DO THE OUTPUT 



DMS# ; POSITION TO NEXT LINE 
ACR,ALF,0 

;D0NE 
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Figure 3.6 
TWX Null Console Manager 



TWXNUL: Turbo-Plus TWXNUL driver 
Copyright 1985, Microserve, Inc. 
Page 1 



Default Shift-In/Shift-Out controls 

AUTHOR: Jim Gabriel 

Microsarve, Inc. 



Edit History: JBG 
JBG 
JBG 
JBG 

MODULE "TWXNUL" 



24-Aug-83 

12™Mar-84 

25-Nov-84 

3~Dec-84 



Revised for TurboDOS VI. 30 
16 bit conversion completed 
1.41 equates added 
Clear status line logic added 



# INCLUDE 
# INCLUDE 



LOG 



"DREQUATE" 
"TEQUATE" 

Data# 



LINE25: 


; 






BYTE 





SI CODE: 


: 






BYTE 


ACR,ALF,0x( 


SOCODE: 


: 






BYTE 


ACR,ALF,0x< 


RSTOOD: 


: 






BYTE 


0,0,0,0,0,1 


i 


LOG 


Code# 


TWXSI: : 


PUSHF 






PUSH 


AX 




PUSH 


CX 




PUSH 


DX 




PUSH 


BX 




MOV 


BX.&SICODE 




JMPS 


SCONT 


TWXSO : : 


PUSHP 






PUSH 


AX 




PUSH 


CX 




PUSH 


DX 




PUSH 


BX 




OR 


AL,=0xFF 




MOV 


LINE25.AL 




MOV 


BX.&SOCODE 




JMPS 


SCONT 



ACR , ALF , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 
ACR , ALF , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 



SAVE FLAGS 
SAVE REGISTERS 



SET HL FOR SHIFT IN 



; SAVE FLAGS 

; SAVE REGISTERS 



SIGNAL THAT A MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 
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TWXNUL: Turbo -PI us TWXNUL driver 
Copyright 1985, Microserve, Inc. 
Page 2 

TWXRST : : 



PUSHF 




PUSH 


AX ; 


PUSH 


CX ; 


PUSH 


DX ; 


PUSH 


BX ; 


XOR 


AL , AL ; 


MOV 


LINE25.AL ; 


MOV 


BX,&RSTCOD ; 






MOV 


DH,CONAST# ; 


CLOOP: 

MOV 


AL,[BX] ; 


OR 


AL,AL ; 


JZ 


SRET ; 


MOV 


DL , AL ; 


MOV 


CL,=COMOUT ; 


PUSH 


DX ; 


PUSH 


BX ; 


XOR 


AL,AL ; 


CALL 


XTNTRY# ; 


POP 


BX ; 


POP 


DX ; 


INC 


BX ; 


JMP 


CLOOP ; 


SRET : POP 


BX ; 


POP 


DX ; 


POP 


CX ; 


POP 


AX ; 


POPF 




RET 





SAVE FLAGS 
SAVE REGISTERS 



SIGNAL THAT NO MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 



GET CONSOLE CHANNEL IN D 
FOR EACH BYTE DO 
GET BYTE IN E 



SET PARM FOR CONOUT 
SAVE CHANNEL NUMBER 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 



RETURN 



END 
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To modify this driver you may either write your own, or use 
the symbolic patch facility. The primary reason to write your 
own would be to perform operations other than a simple console 
output of a string of bytes, such as code to also keep track of 
the cursor position before the message. 

If you wish to do this, the module must meet the following 
specifications: It must have the global entry points TWXSI 
which will be called before every TWX line, to position the 
cursor as desired; TWXSG, which will be called after every TWX 
line, to restore the cursor; and TWXRST, which will be called to 
remove the TWX message from the 25th line. All console output 
must be done via calls to the comm channel, which is defined in 
register DH upon entry to the routine. 

If your only modifications involve changing the string of 
bytes to be sent out before and after each message, it will 
probably be more convenient to use the TurboDOS symbolic patch 
facility. The routine allows fop up to ten bytes to be patched 
at locations SICODE, SOCODE, and BSTCOD for the sequences to be 
sent out before the message, after the message, and to remove the 
message respectively. For example, if you wish to send out five 
bells and a clear screen at the beginning, five bells and a 
carriage return-line feed sequence at the end, and an ESCAPE, 
control-G sequence to remove the message, your .PAR file for the 
slave could be patched as follows, using TWXNUL: 

SICODE ■ 0x07,0x07,0x07,0x07,0x07,0x00 
SOCODE = 0x07, 0x07, 0x07, 0x07, 0x07, 0x0D,0x0A 
HSTCOD = 0xlB,0x07 

However, if you are using one type of terminal frequently, 
it may be easiest to write a special driver for it, even if it 
only involves changing the bytes, so that you need not change 
every .PAR file which you use. An example of such a driver is 
TWXTV, shown in Figure 3.7, written for the Televideo 800, 925, 
and 950 terminals. This driver is designed to take advantage of 
the status line of the terminal. All TWX messages will appear on 
this line, leaving the user's screen intact. 
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Figure 3.7 
TWX Televideo Console Manager 

TWXTV: Turbo-Plus TWXTV driver 
Copyright 1985, Microserve, Inc. 

"Do do 1 



Shift-In/Shift-Out controls for Televideo 925/950/800 series 



AUTHOR: Jim Gabriel 

Microserve, Inc 



Edit History: JBG 
JBG 
JBG 
JBG 



# INCLUDE 
# INCLUDE 



LINE25 
SI CODE 
SOCODE 
RSTCOD 

» 
TWXSI : 



TWXSO 



LOC 

BYTE 

BYTE 

BYTE 

BYTE 

LOC 

PUSHF 

PUSH 

PUSH 

PUSH 

PUSH 

MOV 

JMPS 



PUSHF 

PUSH 

PUSH 

PUSH 

PUSH 

OR 

MOV 

MOV 

JMPS 



24-Aug-83 

12-Mar-84 

25-Nov-84 

3-Dec-84 



Revised for TurboDOS VI. 30 
18 bit conversion completed 
1.41 equates added 
Clear status line logic added 



MODULE "TWXTV" 



"TEQUATE" 
Data# 



ABEL , AESC , 0x67 , AESC , 0x66 , AESC , 0x47 , 0x3C , 0x00 , 0x00 
ACR , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 , 0x00 
AESC , 0x68 ,0,0,0,0,0,0,0,0 
Code# 



AX 

CX 

DX 

BX 

BX.&SICODE 

SCONT 



AX 

CX 

DX 

BX 

AL,=0xFF 

LINE25.AL 

BX,&S0C0DE 

SCONT 



SAVE FLAGS 
SAVE REGISTERS 



SET HL FOR SHIFT IN 



SAVE FLAGS 
SAVE REGISTERS 



SIGNAL THAT A MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 
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TWXTV: Turbo-Plus TWXTV driver 
Copyright 1985, Microserve, Inc 
Page 2 



TWXRST: 


PUSHF 






PUSH 


AX 




PUSH 


CX 




PUSH 


DX 




PUSH 


BX 




XOR 


AL.AL 




MOV 


LINE25,AL 




MOV 


BX.&RSTCOD 


> 
SCOitiT ; 






CLOG 15 * 


MOV 


DH,CGNAST# 


** «*■* *a^ "ter •&* r 


MOV 


AL, [BX) 




OH 


AL.AL 




JZ 


SRET 




MOV 


DL.AL 




MOV 


CL,=COMOUT 




PUSH 


DX 




PUSH 


BX 




XOR 


AL.AL 




CALL 


XTNTRY# 




POP 


BX 




POP 


DX 




INC 


BX 




JMP 


CLOOP 


SRET : 


POP 


BX 




POP 


DX 




POP 


CX 




POP 


AX 




POPF 






RET 





SAVE FLAGS 
SAVE REGISTERS 



SIGNAL THAT NO MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 



GET CONSOLE CHANNEL IN D 
FOR EACH BYTE DO 
GET BYTE IN E 



SET PARM FOR CONOUT 
SAVE CHANNEL NUMBER 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 



RETURN 



END 
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INSTALLING BACKGROUND BATCH 

Overview 

The Turbo-Plus Background Batch System operates on its own 
dedicated slave board. It requires a number of .CMD files and 
related data files. It allows job scheduling, maintains a log of 
batch operation, and offers utilities to list current and pending 
jobs and to delete jobs. 

The batch system requires two user areas: one on the system 
boot disk, and another on any drive on the system. Furthermore, 
it requires the presence of supporting .CMD files in user of 
the system search drive. All of the modules can be easily 
installed in any user area using the background batch 
installation program, BBINSTAL. 

Patc hing 

The program modules which require patching are BB, BB16, 
BB16BACK, BBCANCEL, BB16CANC, BBDEL, BB16DEL, BB16BEG, BBLIST, 
BB16LIST, and BB16L0G. The patches are needed to tell the batch 
system on which user area its files will be kept. To do this 
customisation, run the BBINSTAL program included on the 
distribution diskette. This program will issue a series of 
questions about the manner in which you want to set up your 
background batch. It will then proceed to generate the necessary 
parameter files, and start a DO process to generate the .CMD 
files, and move all of the modules to the necessary user areas on 
the system. A sample background batch installation session 
follows. All user input is underlined. 

5F1 BBINSTAL 

BB requires one user area on the system boot disk where a 
WARMSTBT.AUT file will be placed. Nobody else should log 
on to this area of the boot disk. Which area would you 
like this to be? (1-30): 1 

BB requires one user area anywhere else on the system 
where it maintains all of its files. This should be 
preferably on the hard disk, if you have one. It will 
use user on the drive you select. 

What drive would you like it to use? (A-P): H 

What is your system search drive? (A-P): H 

The Background Batch processor will require one slave 
board dedicated to it. Which slave will you set up 
to service the background batch? (A-P): B 
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TurboDOS 8086 Linker 

Copyright 1984, Software 2000, Inc. 

* BB 

* TPMOD 
Pass 1 

BB TPMOD 

Pass Z 

BB TPMOD 

Processing parameter file "5f:bb.par 

DRIVE = 0x07 

Writing output file "5f:bb.cmd" 



5F1C0PY 

* BBEGIN.CMD 01A:WRM6STRT. AUT:« 

5F:BBEGIN . CMD copied to 1A : WARMS TRT.AUT 

* BB.CMD OH: ;N 

5F:BB .CMD copied to 0H:BB .CMD 

* BBLIST.CMD OH: ;N 

5F:BBLIST .CMD copied to 0H:BBLIST .CMD 

* BBACK.CMD OH: ;N 

5F:BBACK .CMD copied to 0H:BBACK .CMD 



5F) 
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Slave Generation 



Finally, a number of modifications to your system generation 
must be completed: 

Two changes must be made in the system .SYS files: First, a 
new slave must be generated for the batch system. This slave 
should have one change made in its .GEN file: Replace its console 
driver (typically C0N96) with CONBB.O, also supplied on user of 
the installation disk. The slave's .PAR file should be changed 
so that the slave recognizes the default warmstart filename as 

WRM6STRT.AUT' , by inserting the patch WABMFN = 'WBM6STRT' 
Furthermore, the LOGUSR parameter should be included, setting up 
the slave to log automatically onto the user area containing 
WRM6STRT.AUT. (E.g. If you choose to warmstart into user 1 of the 
boot drive, the patch should be LOGUSR = 1.) it is also 
advisable to have this slave printing to some remote queue or to 
file, rather than directly to a printer or to console, since in 
the latter two cases it would be easy to lose desired output 
produced by any jobs running in the batch processor. This is 
accomplished via the PRTMOD and QUEPTR parameters documented in 
the TurboDOS Configuration Guide. This slave must then be 
generated into the system master file, by changing the slave 
table, NMBSLV parameter, and NMBXXX parameter (where XXX is the 
particular slave.) The new slave and master must be generated in 
the normal system generation manner, and the Turbo-Plus batch 
system will be ready for operation upon system reset. 
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Appendix A 
Modifying a Slave Circuit Driver for Turbo-Plus 



If you are using slave boards with incorrect circuit 
drivers, it is highly recommended that you patch the slave 
circuit driver source code (SCD???.A) in order to use TWX and 
BESET commands. 



change to be mads occurs at the end of the interrupt 
service routine in the circuit driver. If the last two lines of 
you? T'CAtine are: 

STI ; Enable Interrupts 

RETI ; Return 

replace them with: 

JMP ISRXIT# ; Jump to ISR exit 

If the last two lines of that routine are different, contact your 
daalsr . 
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